package com.palace.saw.module.app.service.banner;

import java.util.*;
import jakarta.validation.*;
import com.palace.saw.module.app.controller.admin.banner.vo.*;
import com.palace.saw.module.app.dal.dataobject.banner.BannerDO;
import com.palace.saw.framework.common.pojo.PageResult;
import com.palace.saw.framework.common.pojo.PageParam;

/**
 * Banner 广告位 Service 接口
 *
 * @author saw
 */
public interface BannerService {

    /**
     * 创建Banner 广告位
     *
     * @param createReqVO 创建信息
     * @return 编号
     */
    Long createBanner(@Valid BannerSaveReqVO createReqVO);

    /**
     * 更新Banner 广告位
     *
     * @param updateReqVO 更新信息
     */
    void updateBanner(@Valid BannerSaveReqVO updateReqVO);

    /**
     * 删除Banner 广告位
     *
     * @param id 编号
     */
    void deleteBanner(Long id);

    /**
     * 获得Banner 广告位
     *
     * @param id 编号
     * @return Banner 广告位
     */
    BannerDO getBanner(Long id);

    /**
     * 获得Banner 广告位分页
     *
     * @param pageReqVO 分页查询
     * @return Banner 广告位分页
     */
    PageResult<BannerDO> getBannerPage(BannerPageReqVO pageReqVO);

}